Skip to content

Open custom article URI schemes on iOS - #5539

Open
mvanhorn wants to merge 1 commit into
Ranchero-Software:mainfrom
mvanhorn:fix/4866-ios-external-uri-schemes
Open

mvanhorn wants to merge 1 commit into
Ranchero-Software:mainfrom
mvanhorn:fix/4866-ios-external-uri-schemes

Conversation

@mvanhorn

@mvanhorn mvanhorn commented Nov 7, 2026

Copy link
Copy Markdown

Background

On iOS, tapping an article link that uses a custom URI scheme such as octal:// or netnewswire:// does nothing. The same kind of link already opens the destination app on macOS.

The iOS article web view only handed a small allowlist of schemes to the system opener. Custom-scheme taps continued as WKWebView navigation, which cannot launch another app, so the tap had no effect.

Summary of the fix

Custom-scheme URLs are now opened with UIApplication.open so iOS can prompt and switch apps. http, https, mailto, tel, javascript, data, file, about, blob, and vbscript stay on the existing web and system handlers, and internal article image schemes remain excluded. Navigation for other named schemes is cancelled.

Verification

swift test --filter RSWebTests passed Test externalApplicationURLsPassThroughUnchanged. swift test --filter RSWebTests passed Test blocksNonExternalApplicationURLs. swift test --filter RSWebTests passed Test excludesInternalSchemesCaseInsensitively. swift test --filter RSWebTests finished with 39 tests in 8 suites passing. The tests in Modules/RSWeb/Tests/RSWebTests/URLPreparedForOpeningTests.swift fail without the fix in the NetNewsWire URLConstants change (checked by reverting the source changes). The changed test Modules/RSWeb/Tests/RSWebTests/URLPreparedForOpeningTests.swift did not run here: no test runner for it was available.

Fixes #4866

AI was used for assistance.

Custom-scheme URLs are now opened with UIApplication.open so iOS can
prompt and switch apps. http, https, mailto, tel, javascript, data,
file, about, blob, and vbscript stay on the existing web and system
handlers, and internal article image schemes remain excluded. Navigation
for other named schemes is cancelled.

Fixes Ranchero-Software#4866
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Links containing URI schemes to external applications do not work on iOS

1 participant